Summary

Sets up and verifies the development environment for this FastAPI + Jinja2 + PostgreSQL webapp, and documents non-obvious startup caveats for future cloud agents.

Only one file is added (AGENTS.md); no application code was modified.

Environment setup performed

• Installed uv and Python 3.13, synced dependencies (uv sync).
• Installed Docker (with fuse-overlayfs storage driver and containerd-snapshotter disabled for Docker 29) to run Postgres.
• Created .env (git-ignored) with a generated SECRET_KEY and DB_NAME.
• Started Postgres via sudo docker compose up -d.
• Installed Playwright Chromium for the browser tests.

Verification

Hello-world task

Registered a new user (Ada Lovelace) through the browser UI, which auto-logged in and redirected to the dashboard.

register_new_user_hello_world.mp4

Homepage Dashboard after registration Profile

Update script vs AGENTS.md

• Update script (minimal, run on VM startup): uv sync.
• AGENTS.md captures durable, non-obvious run caveats (Docker not managed by systemd → start sudo dockerd; docker needs sudo; .env recreation; Postgres/Playwright requirements for tests).

_{To show artifacts inline, enable in settings.}